Release 10.1A: OpenEdge Development:
Progress 4GL Reference

NODE-VALUE-TO-LONGCHAR( ) method

Copies the contents of an XML X-noderef node to a LONGCHAR, and optionally converts the contents to a specific code page.

Return type: LOGICAL

Applies to: X-noderef object handle

Syntax

NODE-VALUE-TO-LONGCHAR( longchar [ codepage ] )

longchar

An expression of type LONGCHAR.

codepage

A character-string expression that evaluates to the name of a code page. The name you specify must be a valid code page name available in the DLC/convmap.cp file. If you do not specify codepage and the code page of longchar is fixed (that is, set using the FIX-CODEPAGE function), Progress converts longchar to the fixed code page. If you do not specify codepage and the code page of longchar is not fixed, Progress converts longchar to the code page specified by -cpinternal. If you specify codepage and the code page of longchar is fixed, they must agree. Otherwise, Progress raises a run-time error.

NODE-VALUE-TO-LONGCHAR( ) frees the memory currently allocated by longchar (if any), allocates sufficient memory to the LONGCHAR to accommodate the node, and copies the node to the LONGCHAR.

If X-NODEREF:NODE-VALUE is the empty string (""), the resulting longchar has a size of zero length.

For more information on accessing XML documents using the Document Object Model (DOM) interface, see OpenEdge Development: Programming Interfaces .